home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d7 / commo50.arc / HISTORY < prev    next >
Text File  |  1991-09-05  |  20KB  |  474 lines

  1. Recent Revision History
  2. -----------------------
  3.  
  4. This file contains a list of changes to the current release and also to
  5. several recent releases.  If you have used {COMMO} before, please make sure
  6. you are caught up on all the changes and improvements.
  7.  
  8.  
  9. -----------                                                 ---------------
  10. {COMMO} 5.0                                                 August 28, 1991
  11. -----------                                                 ---------------
  12.  
  13. Support File changes since last release
  14. ---------------------------------------
  15.  
  16. Changes are required to the Configuration File and Macro File.  Some changes
  17. may also be needed in your Dialing Directory.  Read the sections below
  18. carefully and also the appropriate sections in COMMO.DOC and MACRO.DOC (now a
  19. separate Macro Programming Guide).
  20.  
  21.  
  22. Configuration File
  23. ------------------
  24.  
  25. The Config File has been replaced with a keyworded Setup File.  This means
  26. that items may be in any order and may vary in number.  In the future it will
  27. only be necessary to add new items if the new features are desired.
  28.  
  29. New items in this release include:
  30.  
  31.  {ddp=2400,8n1,1,A,0}   Default Dialing Parameters
  32.  {min=yes}              Send Modem Init String (yes/no)
  33.  {mac=initmac}          Startup macro label
  34.  {sts=yes}              Status Line on (yes/no)
  35.  {ers=yes}              Make sounds on errors/warnings (yes/no)
  36.  
  37. Plus any number of SET items to set string variables.
  38.  
  39. Keep in mind that the Setup File is only processed at startup.  It may be
  40. edited with the Alt-G command, but the changes do not take effect until the
  41. next time {COMMO} is started.  A new command "[Alt-T]  Set Toggles" has been
  42. added to allow changing many toggle parameters without affecting the permanent
  43. setup.
  44.  
  45.  
  46. Dialing Directory
  47. -----------------
  48.  
  49. A set of Default Dialing Parameters (separate from the Current Terminal
  50. Parameters) is now maintained by {COMMO}.  These parameters are set whenever a
  51. number is dialed unless overridden by a parameter string in the Directory
  52. entry.  They may be changed in the "[Alt-P]  Set Terminal Parameters" window
  53. or with the DPARms macro function.
  54.  
  55. The telephone number field can now have variables to be used as additional
  56. prefixes, suffixes or any other way that you can think of.  Read the Dialing
  57. Directory section in COMMO.DOC if you need to use this feature.
  58.  
  59.  
  60. Macro Processor
  61. ---------------
  62.  
  63. The PgUp and PgDn keys are now used to bring up new Upload and Download menus.
  64. If you need to use these keys for full-screen editing, change the key-labels
  65. in the menus (use F6 in the editor to scroll to the right).
  66.  
  67. You can now define and use string variables within all macro functions.  Read
  68. the section "Programming {COMMO} Macros" in MACRO.DOC for complete details.
  69.  
  70. Macro-id's are now called Macro Labels.  They may be any number of characters
  71. of which the first eight are significant and they must be preceded by a colon.
  72. For example:  {:label}.  Key-id's are now called Key-labels and must have a
  73. colon, also.  See MACRO.DOC for details.
  74.  
  75. A new feature, called Function Switches, allows you to add modifiers to
  76. certain function names to change the action of the function.  The list of
  77. functions in Online Help shows which functions may have switches.  Here are
  78. some examples:
  79.  
  80.     {asci-e file,xyz}           ASCII Upload, expand blank lines
  81.     {asci-s0 file,xyz}          ASCII Upload, do not strinp linefeeds
  82.     {exec-d c:\util\dsz.com}    Direct EXEC
  83.  
  84. All of the "%" parameters in the EXEC function have been eliminated.  Some
  85. have been replaced with string variables, others with switches.  And instead
  86. of "%i" you must now use the new INPUt function prior to the EXEC.
  87.  
  88. These macro functions have been deleted:  CONFig, DELAy, EXED, EXEN, TERMinal.
  89.  
  90. New macro functions are as follows:
  91.  
  92.     ABAUd               This replaces the former AUTObaud.
  93.     AUTOreceive         Set/reset Auto Receive strings.
  94.     COMPare             Compare strings, set conditions.
  95.     DECRement           Subtract from a numeric variable.
  96.     DPARms              Set Default Dialing parameters.
  97.     EDIT                Edit an external file.
  98.     ELAPse              Reset the elapsed timer to 0.
  99.     GETString           Get a string from the modem.
  100.     HFLOw               Toggle Hardware Flow Control.
  101.     IFCOndition         Test conditions set by COMPare.
  102.     INCRement           Add to a numeric variable.
  103.     INPUt               Input a string from the keyboard.
  104.     INSTring            Find a string within a string.
  105.     LENGth              Determine the length of a string.
  106.     RCLOse              Close the read file.
  107.     READ                Read from a disk file.
  108.     ROPEn               Open a file for reading.
  109.     RXMOdem             Receive a file using Xmodem.
  110.     SETEsc              Set a label to GOTO when Esc is pressed.
  111.     SETGet              Set parameters for GETString.
  112.     SETVariable         Assign a string to a variable.
  113.     SFLOw               Toggle Software Flow Control.
  114.     SPOCtrl             Serial port output control.
  115.     SUBString           Extract a substring from a variable.
  116.     SXMOdem             Send a file using Xmodem.
  117.     TOGGles             Open Set Toggles window.
  118.     WCLOse              Close the write file.
  119.     WOPEn               Open a file for writing.
  120.     WRITe               Write to a disk file.
  121.  
  122. Since there is no longer a specific item in the Setup File for upload path
  123. (this is now a user-defined variable), the ASCII Upload window will not
  124. normally show a path in the input field.  You can put in any path you like now
  125. by using the macro:
  126.  
  127.     {:ala} {asci %uldir%\,:}     Use any path or variable.
  128.  
  129. Notice the "\" after the path variable.  This indicates to bring up the window
  130. with the path displayed in the input field.
  131.  
  132. When a macro is running, messages from functions (such as LOOKfor, PAUSe,
  133. etc.) will now be displayed on the left side of the Status Line.
  134.  
  135.  
  136. General
  137. -------
  138.  
  139. {COMMO} now has internal Xmodem.  This is provided for convenience and can
  140. also result in reduced memory usage.  It supports 128 byte or 1k blocks and
  141. CRC or checksum modes.
  142.  
  143. A new key command "[Alt-T]  Set Toggles" allows changing many toggle
  144. parameters without changing the permanent setup.  The following individual
  145. toggle key commands have been eliminated, but may be restored using macros:
  146.  
  147.         Alt-3   Master Sound toggle
  148.         Alt-4   AutoBaud toggle
  149.         Alt-5   Local Echo toggle
  150.         Alt-0   Signal Lights toggle
  151.  
  152. The F1 key is now used for Online Help throughout the program.  To make this
  153. consistent in the Internal Editor, the F1, F2 keys to type curly braces have
  154. been changed as follows:  F2 now types left and right braces alternately (it
  155. is reset to left brace when you move to a new line).  F9 and F10 will type
  156. left and right braces, respectively.  And F7 is now the key to bring up the
  157. Color Chart.
  158.  
  159. Alt-U is now used for the Utility Menu.  Multi Number Dialing is now started
  160. using Alt-N in the Terminal Screen and in the Dialing Directory window.
  161.  
  162. Online Help now requires fewer keypresses to get to a topic.  Just press the
  163. new two character topic code (no Enter necessary).  Also the "keys" in the
  164. topic separators are now "T" followed by any character.  So if you add your
  165. own topic, say "TX", you can bring it up by typing "TX" in the Help window.
  166. You can also use the macro function {help x}.
  167.  
  168. Support has been increased for blind users with speech synthesizers.  Many
  169. prompts and error messages are now displayed through the BIOS when the "BIOS
  170. Terminal Screen and errors" option in the Setup File is set to "yes."
  171.  
  172. The "Other copy of {COMMO} running" message was being erroneously displayed
  173. after some ill-behaved programs were run.  I have added an additional check to
  174. guard against this.
  175.  
  176. The window with the question "Initialize modem?" has been removed.  An item
  177. has been added to the Setup File in its place:  {min=yes/no}.  You can also
  178. use the command line switch: "/iy" or "/in" to override this setting.
  179.  
  180. Using an "=" in command line switches is no longer permitted.  So if you have
  181. a "/i=y", you must change it to "/iy".
  182.  
  183. Some new command line switches have been added.  These override Setup File
  184. items where applicable.  Here is a summary of all command line switches:
  185.  
  186.   /iy, /in              Initialize, don't initialize modem.
  187.   /:label               Startup macro.
  188.   /sfilename            Alternate Setup File.
  189.   /dfilename            Alternate Dialing Directory file.
  190.   /mfilenmae            Alternate default Macro File.
  191.   /knn                  Size of Scrollback Buffer in kbytes.
  192.  
  193. A new search function has been added to the file windows.  In addition to "S",
  194. search for string from top of file, and "A", search again from top of page,
  195. there is now "D", search for a new string from top of page.  The corresponding
  196. function in the Internal Editor is "Alt-D".
  197.  
  198. You can now navigate in a triangle among the Macro Processor, Scrollback and
  199. Dialing Directory windows without having to exit to the Terminal Screen.
  200.  
  201. There is a new input line editor for entering search strings, manual phone
  202. numbers, pathnames, etc.  Keys supported are:  right/left arrow, home/end,
  203. backspace, insert/delete and Alt-Y (clear input field).
  204.  
  205. An "*" next to the column number in the Internal Editor indicates that the
  206. file has outstanding changes.
  207.  
  208. A count of characters received from the serial port appears in the upper left
  209. hand corner of all full-screen windows.
  210.  
  211. The wrapping of the last screen column in ANSI-BBS emulation has been changed
  212. to conform to the method used in VT102.  I.e, the cursor will not wrap on the
  213. last column until another character comes in.  This prevents double-spacing
  214. when lines are exactly as wide as the screen.
  215.  
  216. I have stopped using the BIOS for serial port initialization.  There were too
  217. many non-compatible BIOS's.  PCjr users will have to specify Com2 now if the
  218. internal modem is not installed.
  219.  
  220.  
  221. ------------                                                  ------------
  222. {COMMO} 4.54                                                  May 20, 1991
  223. ------------                                                  ------------
  224.  
  225. Support File changes since last release
  226. ---------------------------------------
  227.  
  228. No changes are required to any of the support files.
  229.  
  230.  
  231. Bugs Fixed
  232. ----------
  233.  
  234. If carrier dropped while a macro was running and the "r" parameter was
  235. specified in a prior MACLoad function, macro processing would continue at an
  236. unpredictable location.  The reload will now wait until macro processing has
  237. STOPped (also, the reload is cancelled by another MACLoad).
  238.  
  239. Scrollback was refusing to display past an EOF character (ASCII 26).  This
  240. caused part of the buffer to be unviewable at times.
  241.  
  242.  
  243. Internal Editor
  244. ---------------
  245.  
  246. You can now split lines and join lines in the Internal Editor!
  247.  
  248.    To split a line at the cursor, just press Enter when Insert Mode is on.
  249.  
  250.    To join two lines, just press Del when the cursor is at the end of the line.
  251.    Or press Backspace when the cursor is in column 1.
  252.  
  253.  
  254. Dialing Directory
  255. -----------------
  256.  
  257. Due to the public outcry concerning the change to the DIAL function, I have
  258. added a third parameter.  This allows the function to behave as it did in
  259. releases prior to 4.53.  Writing:
  260.  
  261.     ... {dial ,,c} ...
  262.  
  263. will cause the Linked Macro to be started with a CALL instead of a GOTO.  The
  264. final RETUrn will transfer control back to the DIAL function, resuming Multi
  265. Number Dialing if any more systems are marked.  PUSH and POPS are not
  266. necessary when the "c" parameter is used.
  267.  
  268.  
  269. Macro Processor
  270. ---------------
  271.  
  272. It is no longer necessary for the Selector Bar to be positioned on a macro-id
  273. to start a macro.  Processing will start at the first macro-id or function on
  274. the selected line.  This makes it a lot easier to test macros by starting at
  275. various locations.  Also, macros in menus no longer require dummy macro-id's.
  276.  
  277. The SETLook parameters (LOOKfor timeout, prompt response) are now reset to
  278. no timeout and no prompt response whenever macro processing stops.  This will
  279. prevent undesired actions when the next macro is started.
  280.  
  281. The split/join addition to the Internal Editor should make it a lot easier to
  282. write and maintain macros (see above).
  283.  
  284. A string may now be specified in the MACRo function.  The line on which the
  285. string appears will be displayed as the top line when the Macro Processor
  286. window is opened.  This is intended for creating menus.  For example:
  287.  
  288.         {nf6} {macro menu1} {}
  289.  
  290. will search for the first occurrence of "menu1" and display from there.
  291.  
  292. Macro errors are now reported in the Macro Processor window.  The offending
  293. line is under the Selector Bar at the top of the screen.
  294.  
  295.  
  296. General
  297. -------
  298.  
  299. The opening Shareware advertisement will automatically terminate after 60
  300. seconds if the key is not pressed.  This will allow testing of unattended
  301. macro runs with the unregistered version.
  302.  
  303. The Left Arrow and Right Arrow keys may now be used to scroll the screen when
  304. the Selector Bar is active (in addition to F3 and F4).  This change applies in
  305. the Dialing Directory, Macro Processor and Scrollback windows.
  306.  
  307.  
  308. ------------                                                --------------
  309. {COMMO} 4.53                                                March 29, 1991
  310. ------------                                                --------------
  311.  
  312. Bugs Fixed
  313. ----------
  314.  
  315. The "other copy of {COMMO} running" check was causing a QEMM exception report
  316. on some Compaq 386 machines.
  317.  
  318. The terminal emulation "insert mode" (ANSI-BBS, VT102) was not moving
  319. characters to the right as new characters were typed.  This would sometimes
  320. cause {COMMO} to crash.
  321.  
  322. The blinking message with the alarm was not always seen under DESQview.
  323.  
  324. A "\" was being added to the upload path in the ASCII Upload window even if
  325. there was no path or only a drive designator.
  326.  
  327. In an effort to reduce the number of erroneous {Off} log entries, I have
  328. stopped writing them unless an {On} entry has been made first.  This will help
  329. modems with carrier detect "bounce."
  330.  
  331.  
  332. Macro Processor
  333. ---------------
  334.  
  335. IMPORTANT:  The DIAL macro function has been changed.  When there is a Linked
  336. Macro in the Dialing Directory, {COMMO} will now do a GOTO instead of a CALL
  337. to the Linked Macro.  A RETUrn at the end of unattended macros no longer goes
  338. back to the DIAL function.  If there is nowhere to return to, the macro will
  339. STOP.  Here are some details (see COMMO.DOC for more):
  340.  
  341.  o  To continue dialing automatically these macros should end with (or GOTO)
  342.     the following sequence (or variation thereof):
  343.  
  344.         ... {setlook 60} {lookfor ^jNO CARRIER^m} {dial ,} {}
  345.  
  346.  o  This means that you can now call more than one system automatically when
  347.     you:
  348.  
  349.       1)  Use Dialing Strings on the command line.
  350.       2)  Mark numbers manually and press Alt-U.
  351.  
  352.  
  353. New function (see COMMO.DOC for details):
  354.  
  355.   IFCArrier     This function will test for the presence of carrier detect.
  356.  
  357.  
  358. There is no longer a restriction on when COMMO.MAC can be reloaded when using
  359. the "r" parameter of the MACLoad function.  If you are in a file window
  360. (including the Macro Processor), it will reload when the window is exited.
  361.  
  362. Some of the macros in MACROS.TXT have been updated.  In particular, the
  363. Generic Login Subroutine will now handle more boards.
  364.  
  365.  
  366. General
  367. -------
  368.  
  369. The Auto Receive feature has been improved.  There is no longer a time period
  370. following a trigger when another one is disallowed.  Instead, the serial port
  371. input buffer is cleared when returning from an EXECute-type function (during
  372. the trigger macro only).
  373.  
  374. The Capture Mode can now be changed manually in the Capture File Options
  375. window.
  376.  
  377. A Status Line message will be displayed during SEND functions that have any
  378. (~) delay characters.
  379.  
  380.  
  381. ------------                                                -------------
  382. {COMMO} 4.52                                                March 2, 1991
  383. ------------                                                -------------
  384.  
  385. Bugs Fixed
  386. ----------
  387.  
  388. A few users were having a problem with output data being sent repeatedly.  The
  389. program had to be terminated to get out of it.  I was unable to recreate this
  390. myself (I suspect flaky hardware).  I have changed the transmit logic to
  391. accommodate more conditions and I would appreciate hearing from anyone who had
  392. this problem.
  393.  
  394. The prompt timer in the LOOKfor function was expiring early when a beep was
  395. sounded.  This caused difficulty in PCBoard login macros, for example, causing
  396. an "n|" to be sent too soon.
  397.  
  398. The timer for the modem init string at program startup was beginning before
  399. the string was sent instead of after, leaving very little time for the modem
  400. to settle before dialing began.
  401.  
  402.  
  403. --------------------
  404. Support File Changes
  405. --------------------
  406.  
  407. Configuration File
  408. ------------------
  409.  
  410. This release uses the same configuration file as 4.5 and 4.51.
  411.  
  412.  
  413. Dialing Directory
  414. -----------------
  415.  
  416. The [M] command, Manual Dial, no longer makes an entry in the Directory.
  417. Instead the number last entered is displayed when you press [M] again.  [N] is
  418. no longer an option.  Sorry, but this feature was incompatible with some of
  419. the recent changes and had to be sacrificed.
  420.  
  421.  
  422. Macro Processor
  423. ---------------
  424.  
  425. Macro Processing has been streamlined to make execution of long macros even
  426. faster.  The macro error window will now show the closest macro-id prior to
  427. the errant function.
  428.  
  429. Now you can have as many as 15 GOLOoks plus the LOOKfor, for a total of 16
  430. strings that can be scanned for at one time.
  431.  
  432. New functions (see COMMO.DOC for details on these functions):
  433.  
  434.   STATusline    This function will turn the Status Line on or off at
  435.                 any time.
  436.  
  437.   PUSHstack     This will save a macro location to the macro stack.  It is
  438.                 primarily useful for turning GOLOoks into subroutine calls.
  439.  
  440.   POPStack      Removes an element from the macro stack.  Used when a return
  441.                 from a GOLOok is not needed.
  442.  
  443. General
  444. -------
  445.  
  446. Now you can press the [Spacebar] in ASCII Upload to get things moving when
  447. {COMMO} is waiting for a pacing character that won't come. This helps when you
  448. have specified the wrong pacing character or if you intentionally want to
  449. manually pace the output, line by line.
  450.  
  451. A new key has been added in the Scrollback window.  Pressing [C] will let you
  452. change the Screen Image pathname without leaving the window.
  453.  
  454. Doorway Mode will now use the number of text lines on the display (instead of
  455. forcing 25 lines).  This means that you must set the display correctly before
  456. starting {COMMO}.  Most Doorway applications require the normal 25 line
  457. display, but {COMMO} will now handle more lines if required.
  458.  
  459. The Status Line may now be turned on while in Doorway Mode.  See the details
  460. under "Doorway Mode" in COMMO.DOC.  Also, the DOORway macro function no longer
  461. has a y/n argument.  It was too easy to get stuck in Doorway Mode!
  462.  
  463. VT102 terminal emulation has been improved by holding the cursor in column 80
  464. when 80 column lines are displayed.  This will prevent double spacing when
  465. linewrap in on (linewrap now defaults to ON when you switch emulations).
  466.  
  467. A message will be displayed for several seconds at startup if another copy of
  468. {COMMO} is running.  This warning is intended to reduce the chance of losing
  469. support file data when files are saved at program exit (does not seem to work
  470. between DESQview windows, however).
  471.  
  472.  
  473.                                -end-
  474.